home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / archiver / pax2exe.zip / PAX.MAN < prev    next >
Text File  |  1990-02-25  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4. PAX(1)              UNIX Programmer's Manual               PAX(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      pax - portable archive exchange
  10.  
  11. SYNOPSIS
  12.      pax [-cimopuvy] [-f archive] [-s replstr] [-t device] [pat-
  13.          tern...]
  14.  
  15.      pax -r [-cimnopuvy] [-f archive] [-s replstr] [-t device]
  16.             [pattern...]
  17.  
  18.      pax -w [-adimuvy] [-b blocking] [-f archive] [-s replstr]
  19.             [-t device] [-x format] [pathname...]
  20.  
  21.      pax -rw [-ilmopuvy] [-s replstr] [pathname...] directory
  22.  
  23. DESCRIPTION
  24.      Pax reads and writes archive files which conform to the
  25.      Archive/Interchange File Format specified in IEEE Std.
  26.      1003.1-1988.  Pax can also read, but not write, a number of
  27.      other file formats in addition to those specified in the
  28.      Archive/Interchange File Format description.  Support for
  29.      these traditional file formats, such as V7 tar and System V
  30.      binary cpio format archives, is provided for backward compa-
  31.      tibility and to maximize portability.
  32.  
  33.      Pax will also support traditional cpio and System V tar
  34.      interfaces if invoked with the name "cpio" or "tar" respec-
  35.      tively.  See the cpio(1) or tar(1) manual pages for more
  36.      details.
  37.  
  38.      Combinations of the -r and -w command line arguments specify
  39.      whether pax will read, write or list the contents of the
  40.      specified archive, or move the specified files to another
  41.      directory.
  42.  
  43.      The command line arguments are:
  44.  
  45.      -w   writes the files and directories specified by pathname
  46.           operands to the standard output together with the path-
  47.           name and status information prescribed by the archive
  48.           format used.  A directory pathname operand refers to
  49.           the files and (recursively) subdirectories of that
  50.           directory.  If no pathname operands are given, then the
  51.           standard input is read to get a list of pathnames to
  52.           copy, one pathname per line.  In this case, only those
  53.           pathnames appearing on the standard input are copied.
  54.  
  55.      -r   Pax reads an archive file from the standard input.
  56.           Only files with names that match any of the pattern
  57.           operands are selected for extraction.  The selected
  58.           files are conditionally created and copied relative to
  59.           the current directory tree, subject to the options
  60.  
  61.  
  62.  
  63. Printed 2/26/90                                                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PAX(1)              UNIX Programmer's Manual               PAX(1)
  71.  
  72.  
  73.  
  74.           described below.  By default, the owner and group of
  75.           selected files will be that of the invoking process,
  76.           and the permissions and modification times will be the
  77.           sames as those in the archive.
  78.  
  79.           The supported archive formats are automatically
  80.           detected on input.  The default output format is ustar,
  81.           but may be overridden by the -x format option described
  82.           below.
  83.  
  84.      -rw  Pax reads the files and directories named in the path-
  85.           name operands and copies them to the destination direc-
  86.           tory.  A directory pathname operand refers to the files
  87.           and (recursively) subdirectories of that directory.  If
  88.           no pathname operands are given, the standard input is
  89.           read to get a list of pathnames to copy, one pathname
  90.           per line.  In this case, only those pathnames appearing
  91.           on the standard input are copied.  The directory named
  92.           by the directory operand must exist and have the proper
  93.           permissions before the copy can occur.
  94.  
  95.      If neither the -r or -w options are given, then pax will
  96.      list the contents of the specified archive.  In this mode,
  97.      pax lists normal files one per line, hard link pathnames as
  98.  
  99.                pathname == linkname
  100.  
  101.      and symbolic link pathnames (if supported by the implementa-
  102.      tion) as
  103.  
  104.                pathname -> linkname
  105.  
  106.      where pathname is the name of the file being extracted, and
  107.      linkname is the name of a file which appeared earlier in the
  108.      archive.
  109.  
  110.      If the -v option is specified, then pax list normal path-
  111.      names in the same format used by the ls utility with the -l
  112.      option.  Hard links are shown as
  113.  
  114.                <ls -l listing> == linkname
  115.  
  116.      and symbolic links (if supported) are shown as
  117.  
  118.                <ls -l listing> -> linkname
  119.  
  120.  
  121.      Pax is capable of reading and writing archives which span
  122.      multiple physical volumes.  Upon detecting an end of medium
  123.      on an archive which is not yet completed, pax will prompt
  124.      the user for the next volume of the archive and will allow
  125.      the user to specify the location of the next volume.
  126.  
  127.  
  128.  
  129. Printed 2/26/90                                                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PAX(1)              UNIX Programmer's Manual               PAX(1)
  137.  
  138.  
  139.  
  140.      Options
  141.      The following options are available:
  142.  
  143.      -a        The files specified by pathname are appended to
  144.                the specified archive.
  145.  
  146.      -b blocking
  147.                Block the output at blocking bytes per write to
  148.                the archive file.  A k suffix multiplies blocking
  149.                by 1024, a b suffix multiplies blocking by 512 and
  150.                a m suffix multiplies blocking by 1048576 (1 mega-
  151.                byte).  For machines with 16-bit int's (VAXen,
  152.                XENIX-286, etc.), the maximum buffer size is 32k-
  153.                1.  If not specified, blocking is automatically
  154.                determined on input and is ignored for -rw.
  155.  
  156.      -c        Complement the match sense of the pattern
  157.                operands.
  158.  
  159.      -d        Intermediate directories not explicitly listed in
  160.                the archive are not created.  This option is
  161.                ignored unless the -r option is specified.
  162.  
  163.      -f archive
  164.                The archive option specifies the pathname of the
  165.                input or output archive, overriding the default of
  166.                standard input for -r or standard output for -w.
  167.  
  168.      -i        Interactively rename files.  Substitutions speci-
  169.                fied by -s options (described below) are performed
  170.                before requesting the new file name from the user.
  171.                A file is skipped if an empty line is entered and
  172.                pax exits with an exit status of 0 if EOF is
  173.                encountered.
  174.  
  175.      -l        Files are linked rather than copied when possible.
  176.  
  177.      -m        File modification times are not retained.
  178.  
  179.      -n        When -r is specified, but -w is not, the pattern
  180.                arguments are treated as ordinary file names.
  181.                Only the first occurrence of each of these files
  182.                in the input archive is read.  The pax utility
  183.                exits with a zero exit status after all files in
  184.                the list have been read.  If one or more files in
  185.                the list is not found, pax writes a diagnostic to
  186.                standard error for each of the files and exits
  187.                with a non-zero exit status.  the file names are
  188.                compared before any of the -i, -s, or -y options
  189.                are applied.
  190.  
  191.      -o        Restore file ownership as specified in the
  192.  
  193.  
  194.  
  195. Printed 2/26/90                                                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PAX(1)              UNIX Programmer's Manual               PAX(1)
  203.  
  204.  
  205.  
  206.                archive.  The invoking process must have appropri-
  207.                ate privileges to accomplish this.
  208.  
  209.      -p        Preserve the access time of the input files after
  210.                they have been copied.
  211.  
  212.      -s replstr
  213.                File names are modified according to the substitu-
  214.                tion expression using the syntax of ed(1) as
  215.                shown:
  216.  
  217.                          -s /old/new/[gp]
  218.  
  219.                Any non null character may be used as a delimiter
  220.                (a / is used here as an example).  Multiple -s
  221.                expressions may be specified; the expressions are
  222.                applied in the order specified termina